# SAML SSO - Okta

The ABsmartly Web Console supports SAML SSO with Okta. This guide will walk you through the steps to get it set up!

## Configuring Okta

In Okta, login as an administrator and ensure that you are in the Classic UI.

Once there, expand the Application menu on the left and click on Applications. Once there, click the Create App Integration button.

![Okta Applications page with a Create App Integration button](/assets/images/applications-e5d50986efe483ee136dd3a3fd015167.png)

### Create a SAML Application

Choose **SAML 2.0** as the Sign on method and click `Next`.

![Okta Create New SAML Application dialog](/assets/images/create_new_saml_application-7bc9c971e3cc1da31c96214a945c472e.png)

Provide an **App name** and click `Next`.

> **App Image**
>
> For an **App Image**, feel free to download our logo here: <https://docs.absmartly.com/img/logo.png>
>
> ![The ABsmartly logo](/assets/images/logo-0532e45efbb50515b2d04a56e20f1d5a.png)
>
> It can be added to the Okta integration by clicking on the **Upload Logo** button and selecting the downloaded image.
>
> ![Okta Upload Logo button](/assets/images/upload_logo-a10039a7d8599c719b654400e6ea36ce.png)

![Okta Create SAML Integration step 1](/assets/images/create_saml_integration_1-84eb840b3cb9007a58850c456b97c775.png)

In the SAML Settings section, paste your provided SSO url into the **Single sign on URL** field and set the **Audience URI (SP Entity ID)** field to `absmartly`. The **Name ID format** should be set to `EmailAddress`, the **Application username** should be set to `Email` and **Update application username on** should be set to `Create and update`.

> **info**
>
> Your SSO url will be provided by ABsmartly, but it usually takes the form of:
>
> ```text
> https://<your-assigned-subdomain>.absmartly.com/auth/saml/okta/callback
> ```

In the Attribute Statements section, click `Add Another` and add the following attributes:

* `firstName` - `Basic` with a value of `user.firstName`
* `lastName` - `Basic` with a value of `user.lastName`
* `department` - `Basic` with a value of `user.department`

We use these attributes to set up each user's name and department in ABsmartly. To assign ABsmartly roles from Okta, also add a `roles` attribute, see [Assigning Roles](<https://docs.absmartly.com/docs/Third-party-integrations/SSO/SAML Role Mapping.md>). Click the `Next` button.

![Okta Create SAML Integration step 2](/assets/images/create_saml_integration_2-a2e13771e29d0574318e9efb085a8748.png)

Finally, choose `I'm an Okta customer adding an internal app` and click `Finish`.

![Okta Create SAML Integration step 3](/assets/images/create_saml_integration_3-5e88c7068d23a6600096445dbcd1ad9d.png)

### Add Users to your SSO Integration

After the previous step, you will be redirected to the `Sign on` tab of your newly created SAML application. Click on the `Assignments` tab to start defining who can sign in with Okta. Click on `Assign` and either `Assign to People` or `Assign to Groups` depending on your needs.

![Okta Assignments tab](/assets/images/assignments-b3daf9095e01fdbe173815eed90ff8dc.png)

## Sending Us The Integration Metadata

Once you have completed the previous steps, you will need to send us the integration metadata. To do this, click on the `Sign on` tab of your newly created SAML application and scroll down to the SAML Signing Certificates section.

Click the actions button next to your most recently created Signing Certificate and select `Download Certificate`.

![Okta Download IdP metadata](/assets/images/view_idp_metadata-9d35f7d30fc8586b0e765384920bc259.png)

After downloading the metadata, send it to us via email or Slack and your employees will be able to sign in to ABsmartly using Okta!

## See also

* [Federated OIDC access tokens](https://docs.absmartly.com/docs/APIs-and-SDKs/Federated-Authentication/federated-oidc-tokens.md#okta-example) — let your own backend call the ABsmartly REST API or MCP server on behalf of users signed in with Okta. Okta users are linked by their Okta user ID (`uid`), which your SAML app sends as an extra attribute at sign-in.
